home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-19 / ash151.zip / ASH.DOC < prev    next >
Text File  |  1992-08-05  |  10KB  |  227 lines
  1.  
  2.  
  3.  
  4.  
  5.                           Alchemy Shell 1.5.1
  6.  
  7.                A graphical shell for Image Alchemy 1.5.1
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                    by Edwin Groothuis, Augustus 1992
  24.  
  25. «« What is Alchemy Shell?
  26.  
  27.    This program is a graphical shell for Image Alchemy 1.5.1 of Handmade
  28.  Software. I wrote this shell because I was tired of searching for the
  29.  correct parameters that Alchemy needed for correct conversion.
  30.  
  31.    This program is shareware. It may not be spread without documentation
  32.  or sold for more than US$ 3.-. It may be spread free via bulletin board
  33.  systems, Internet or other public networks. If you distribute it as part
  34.  of a shareware-disk, please let me know.
  35.  
  36.    For information about registering see below.
  37.  
  38. «« What is required for Alchemy Shell?
  39.  
  40.    Alchemy Shells requires three things:
  41.  o A IBM-compatible computer with compatible VGA-card. (This program uses
  42.    videomode 12h. It's a standard VGA-mode)
  43.  o A mouse and mousedriver. Most computers today have this.
  44.  o The program Image Alchemy 1.5.1 (called ALCHEMY.EXE). Please put
  45.    ALCHEMY.EXE and ASH.EXE in the same directory, since ASH.EXE searches
  46.    for ALCHEMY.EXE only in the same directory as ASH.EXE is.
  47.  
  48. «« How to use Alchemy Shell?
  49.  
  50.    To run Alchemy Shell, type ASH with as optional parameter the sourcefile.
  51.  Now you get a graphical screen with several windows like this:
  52.  
  53.  ┌─────────────────────────────────────────────────────────────────────────┐
  54.  ├─────────────────────────────────────────────────────────────────────────┤
  55.  │                 A┌────────┐B┌───┐              ┌───────────────┬─┐K     │
  56.  │   Sourcefile     └────────┘ └───┘              │J              ├─┤      │
  57.  │                 C┌────────┐                    │               │ │      │
  58.  │   Destination    └────────┘                    │               │ │      │
  59.  │                 D┌─┬E┬─┐F                      │               │ │      │
  60.  │   Colorbits      └─┴─┴─┘                       │               │ │      │
  61.  │                 G┌───┐                         │               │ │      │
  62.  │   XSize          └───┘                         │               │ │      │
  63.  │                 H┌───┐                         │               │ │      │
  64.  │   YSize          └───┘                         │               │ │      │
  65.  │                 I┌─┐                           │               │ │      │
  66.  │   Overwrite      └─┘                           │               ├─┤      │
  67.  │                                                └───────────────┴─┘L     │
  68.  │        ┌────────────────┐               ┌────────────────┐              │
  69.  │        │     G O        │               │    CANCEL      │              │
  70.  │        │               M│               │               N│              │
  71.  │        └────────────────┘               └────────────────┘              │
  72.  │                                                                         │
  73.  └─────────────────────────────────────────────────────────────────────────┘
  74.  
  75.  Legend:
  76.    A: Click here to change the name of the sourcefile.
  77.       After clicking the (old) name will disappear and you can enter a
  78.       new name. Finishing with ENTER (accept name) or ESCAPE (keep old name).
  79.       After typing 13 characters (=a complete filename) the inputline
  80.       will automatic close.
  81.    B: Browse for a file. See below
  82.    C: Click here to change the name of the destinationfile. See also A.
  83.    E: Selected number of colorbits. Possible are 8, 15, 16, 24 or 32 bits.
  84.       Some images require only 8 colorbits (like the GIF-format),
  85.       some images can handle more colorbits (like the TIFF-format).
  86.    D,F: Select previous or next number of colorbits.
  87.    G: Click here for a new image-width. This can be up to 9999 pixels.
  88.       (Note: The unregistered version of Image Alchemy can only handle up
  89.        to 640x480 pixels).
  90.       After clicking the (old) X-Size will disappear and you can enter
  91.       a new X-Size. Finishing with ENTER (accept new size) or
  92.       ESCAPE (keep old size). After typing four digits (=maximal number
  93.       of digits) the inputline will automatic close.
  94.    H: Click here for a new image-height. See also G.
  95.    I: Click here if you want to toggle overwrite. Image Alchemy normally
  96.       requires the parameter -o to overwrite. If you don't want to overwrite
  97.       a old file, please click here. The "√" will disappear.
  98.    J: List of new image-formats. Click on one to choose the new format.
  99.       After clicking, the extension of the destinationfile will automatic
  100.       be converted to the "normal" extension of that image-format.
  101.    K,L: Click here for going higher or lower in the list. If you can't
  102.       go any further, you'll here a beep.
  103.    M: GO: start conversion and go back to dos.
  104.    N: cancel: cancel conversion, go back to dos.
  105.  
  106. «« Browse for a file.
  107.  
  108.    After clicking on B, a new window will appear:
  109.  
  110.  ┌─────────────────────────────────────────────────────────────────────────┐
  111.  ├─────────────────────────────────────────────────────────────────────────┤
  112.  │   ┌─────────────────────────────────────────────────────────────────┐   │
  113.  │   ├────────────────────────────────────────────────────O┬───────────┤   │
  114.  │   │S                                                   P├───────────┤   │
  115.  │   │                                                     ├───────────┤   │
  116.  │   │                                                    Q├───────────┤   │
  117.  │   │                                                     │   o k     │   │
  118.  │   │                                                     ├───────────┤   │
  119.  │   │                                                    R├───────────┤   │
  120.  │   │                                                     │  cancel   │   │
  121.  │   │                                                     ├───────────┤   │
  122.  │   │                                                     │           │   │
  123.  │   │                                                     │           │   │
  124.  │   │                                                     │           │   │
  125.  │   │                                                     │           │   │
  126.  │   │                                                     │           │   │
  127.  │   │                                                     │           │   │
  128.  │   │                                                     │           │   │
  129.  │   └─────────────────────────────────────────────────────┴───────────┘   │
  130.  └─────────────────────────────────────────────────────────────────────────┘
  131.  Legend
  132.    O: Change the searchmask to *.*
  133.    P: Choose a custommask (wildchards etc. are allowed). See alse A
  134.    Q: Click here when you've choosen the correct file. On the mainwindow,
  135.       the name of the sourcefile will change into the selected file and
  136.       the name of the destinationfile with the correct extension.
  137.    R: Click here to cancel the browse-menu
  138.    S: Here are the names of the files in the current directory that
  139.       match the gives mask. Click on one to choose.
  140.  
  141. «« After typing GO
  142.  
  143.    When you've clicked on GO, the graphical screen will disappear and the
  144.  normal textscreen will appear. The program Image Alchemy is automatic
  145.  executed with the selected parameters. When your image is converted, the
  146.  normal dos-prompt will return. If Image Alchemy has found any errors, it
  147.  is displayed on the screen by Image Alchemy.
  148.  
  149. «« Known bugs
  150.  
  151.  o Sometimes Image Alchemy will give the warning "options -8, -c2 and -b
  152.    assumed". This can happen if you're converting a image to black-and-white
  153.    images like Postscript, HP PCL and Freedom of Press.
  154.  
  155.  o Alchemy Shell doesn't do a detect for the mouse. Press ESCAPE if your
  156.    mouse doesn't respond.
  157.  
  158. «« Registrering
  159.  
  160.  You can register Alchemy Shell by filling in the registerform and
  161.  sending US$ 15,- or more to
  162.      "Alchemy Shell reg."
  163.  p/a Edwin Groothuis
  164.      Johann Strausslaan 1
  165.      5583ZA Aalst-Waalre
  166.      The Netherlands
  167.  
  168.  Please note
  169.   o Cheques must be made payable to Edwin Groothuis
  170.  
  171.   o Payment may be made by sending cash in an envelope (Use registered
  172.     mail!) or by sending a Eurocheque (in Europe). If you send a cheque
  173.     other than a Eurocheque add US$ 5,- for bank charges.
  174.   
  175.  When you register, you get a registered copy with the next features:
  176.  o real scrollbars at the new imageformats-selection
  177.  o selection for number of colors (0 until 256)
  178.  o return to Alchemy Shell after using Image Alchemy.
  179.  o custom-preferences like: o establishing of default number of colorbits
  180.                             o sequence of new imageformats
  181.                             o default directory-mask
  182.  o new features asked by other people who registered it
  183.  o my infinite thanks
  184.  
  185.  If you keep using this program, but don't want to register it, would
  186.  you be so kind to send me a picture postcard of your town, village etc.
  187.  
  188. «« Ideas, hints, remarks, comments etc.
  189.  
  190.    If you've a something to ask about Alchemy Shell, please don't
  191.  hesitate and let me know. You can contact me at the following ways:
  192.  
  193.  o E-mail     : till june 1993: S89405079@hse.nl
  194.  o Normal mail: See above at Registering
  195.  o BBS        : ECA-BBS phone +31-40-550352
  196.  o Phone      : Can't give you, because I'm never at home. Try by mail.
  197.  
  198.                    REGISTER FORM ALCHEMY SHELL 1.5.1
  199.  
  200.     Name: ________________________________________________________
  201.  
  202.  Address: ________________________________________________________
  203.  
  204.     City: ________________________________________________________
  205.  
  206.    State: ________________________________ Zip Code: _____________
  207.  
  208.  Country: ________________________________ Phone: ________________
  209.  
  210.     Date: _________________________
  211.  
  212.  DISKFORMAT:    o 3.5" DD      o 5.25" HD
  213.  
  214.  Do you want
  215.  
  216.     to register Alchemy Shell 1.5.1                        O
  217.     to register the last version (if available)            O
  218.  
  219.     to be inquired when a new release of Alchemy Shell
  220.       is released                                          O
  221.  
  222.     a version with no 8086/8088 commands
  223.       (this is nearly 1 Kb smaller of code)                O
  224.  
  225.     included a copy of Image Alchemy 1.5.1 (ZIPped)        O
  226.  
  227.